BBS Toolkit

home *** CD-ROM | disk | FTP | other *** search

/ BBS Toolkit / BBS Toolkit.iso / pc_board / cml_inst.zip / INSTALL.DOC < prev

Wrap

Text File | 1991-11-19 | 15KB | 354 lines

******************************************************************************* IMPORTANT: SHARE.EXE must be loaded to run CAM-MAIL. If you do not have SHARE loaded the door will LOCK up when Uploading a .REP file. ******************************************************************************* DISCLAIMER ---------- This software is provided without any guarantee, either expressed or implied. All responsibilities for its use rest with the user of the software and not the author. Cam-Mail software and this document is (C) Copyright 1991 Cam N. DeBuck. All rights reserved World Wide. License ------- Cam-Mail is not in the Public Domain. Cam-Mail is not free. Non-registered users are granted a limited, 30-day license to determine whether or not the program meets their needs. Continued use of Cam-Mail beyond the 30-day evaluation time period requires registration of the program. Use of non- registered copies of Cam-Mail beyond the original evaluation period is strictly prohibited. No one may modify Cam-Mail for any reason, in any way, including but not limited to, decompiling-compiling, patching, disassembling, or reverse engineering the program. Cam-Mail may be copied and distributed to others, subject to the above restrictions and the following: Cam-Mail must be copied in unmodified form, including the file containing this license information. Complete Cam-Mail documentation and Online Help must be included. No copying fee of any type may be assessed other than basic charges for the cost of the copying medium. Cam-Mail may not be distributed with any other software or hardware product(s) without the express written permission of the author, Cam N. DeBuck. Sysops (bulletin board SYStem OPerators) may make Cam-Mail available for downloading by their users as long as all above conditions are met. Commercial Distributors of Public Domain, ShareWare, or User- Supported software may distribute Cam-Mail subject to the above conditions only after obtaining specific written permission from the author, Cam N. DeBuck and filling out a registration form for upgrade notifications. This condition supersedes any and all previous agreements. Cam-Mail v1.0 Installation Documentation First, let's make this short and simply. Follow the instructions to a tee and nothing can go wrong: 1) Take *ALL* nodes down. 2) Go into your PCB directory and run PCBSM.EXE 3) Go into D User Info File Maintenance 4) Go into C Add/Update Third Party Application 5) Enter Name of Third Party Application ? CAM-MAIL 6) Version: 1 7) Static Size: 60 8) Dynamic Size: 1 9) KeyWord: MAIL 10) Press PGDN to begin! 11) At this point you can bring up all your nodes if you would like. 12) Go into your PCB directory and run PCBSETUP.EXE. 13) Edit your DOORS.LST file in which conference you have your doors in and add the door by the name of: MAIL (Create USERS.SYS is Yes) 14) That's it for the PCBoard side of the installation. Now let's go install the door itself: 15) Create a directory called: \CAM-MAIL (I suggest from the root directory, but it not necessary). All defaults are setup using the directory \CAM-MAIL. 16) Change to the directory you just created and unzip the CAM-M1Bx.ZIP file or the START.ZIP file (The actual filename will vary depending on which version you have or where you got it from). 17) Create several directories called: \CAM-MAIL\FILES \CAM-MAIL\BLTS \CAM-MAIL\HELP \CAM-MAIL\OFFLINE Or if you prefer to use different paths, the CMSM will create the new paths for you after editing the fields. 18) Run CMSM.EXE and go into E Misc Paths 19) Change the Paths if Necessary and select the Work Drive. Be sure CMSM asks you to create the directories to avoid any problems. 20) Select C Download Limits 21) First, a tidbit of information. As of this writing most Off-Line Readers only allow 200 messages per conference. Please keep that in mind when selecting the number of messages per conference. However, for NetMail Systems, you can have as many messages as possible. 22) It is up to you that you select the number of messages the user can download per conference and per QWK Packet (Total Messages). I personally believe that you should set the number of messages per conference to 200 for each Connect Rate. However, this is what I suggest for the Total Number of Messages per packet: Connect Rate Msgs Per Conf Msgs Per Packet ------------ ------------- --------------- 300 200 200 1200 200 400 2400 200 600 4800 200 800 9600 200 1000 14400 200 1000 23) If you have any special security levels (Such as friends or NetMail systems) you will probably want to use the Security Specific area for these security levles. The Security Specific area will override the Default settings no matter what Baud Rate they call in at. This comes in very handy for Anybody that you want to give NetStatus to if you're acting as a HUB. This way you won't have to go into the this program to update their NetStatus flag (The door will automatically do it for you). I have no suggestions for any numbers in this area as it will vary for each BBS System. 24) Number of *.QWK's for Upload Credit? Use this area if you wish to give users upload credits for upload QWK packets. *** Anything beyond this point is optional and may not be required. Bulletin Scanning ----------------- NOTE: CMSM.EXE creates a file (If you have bulletins scanned for a particular conference) called CAMBxxx (where xxx is the conference number). I had a slight problem previously with people having the same names for their actual bulletin names. Be sure you don't have this problem by using a different path to the Bulletin Files (I suggest the CAM-MAIL directory). 25) Go into A Bulletin Scanning. Please note, depending on the number of conferences that you have, it might take a little bit for CMSM to setup the conference information for the bulletins. 26) Select a Conference(s) that you wish to have Bulletins Scanned and hit return. A) Another menu will pop up on the side if you have any bulletins in this conference. B) Now select the Bulletins you want to scan for by pressing the RETURN key. A CheckMark will appear by bulletins that you have selected. To turn a bulletin off (After selecting one), use the RETURN key once again. C) In most cases you will only want to select Bulletins that are updated on a Daily or Weekly Basis (Or monthly). D) Use the ESC key to return back to the Conference Area. A check mark will appear by the conference name if you have any bulletins selected. New Files Scanning ------------------ NOTE: CMSM.EXE creates a file (If you have new files scanned for a particular conference) called CAMFxxx (where xxx is the conference number). I had a slight problem previously with people having the same names for their actual DIR files. Be sure you don't have this problem by using a different path to the New Files Directory (I suggest CAM-MAIL). 27) Go into D Files Scanning. Please note, depending on the number of conferences that you have, it might take a little bit for CMSM to setup the conference information for the File Listings. 28) Select a Conference(s) that you wish to have Directories Scanned and hit return (These are your DIRxx files). A) Another menu will pop up on the side if you have any DIR's in this conference. B) Now select the DIR you want to scan for by pressing the RETURN key. A CheckMark will appear by DIR's that you have selected. To turn a DIRn off (After selecting one), use the RETURN key once again. C) In most cases you will only want to select DIR's that are updated on a Daily or Weekly Basis (Or monthly). This would definately include your Upload Directory. D) Use the ESC key to return back to the Conference Area. A check mark will appear by the conference name if you have any bulletins selected. Compression ----------- 29) You can have as many as 5 different compression methods available to your users. At this point of writing the most dominant compression method is PKZip. If you are installing the door for the first time this compression has already been setup for you (Including the necessary batch files). Please note that Archive #1 is the default that is used for New Users. 30) Find an Empty Archive name and enter in a name. 31) Now Add the Archive Letter you wish to use. 32) At this point you will need to exit the program and create 2 batch files by this format: CAMZIPx.BAT (Where x is the Archive Letter). CAMUZIPx.BAT (Where x is the Archive Letter). 33) CAMZIPx.BAT has two parameters passed to it: %1 - The Path/Name of the QWK Packet %2 - The files to be Archived. Sample Batch file would look like this for PKZip: PKZIP -es %1 %2 34) CAMUZIPx.BAT has three paramters passed to it: %1 - The Path/Name of the REP Packet %2 - The File to be UnArchived %3 - The Path of the WORK Directory (A trailing '\' is not included). Sample Batch file would look like this for PKUNZip PKUNZIP %1 %2 %3 35) That's all there is to Compresssion Area. Internal Protocols ------------------ 36) You have the option of turning ON/OFF Internal Protocols. I suggest that you leave all of them on. External Protocols ------------------ 37) You can have up to 10 different External Protocols. 38) The Protocol in the Upper Left Hand corner is the default protocol for New Users. I suggest that you have Zmodem in this position. If you are installing this door for the first time Zmodem has already been installed for you. 39) Find a Blank Protocol and Add a Protoocol Name. 40) Enter in the Protocol Letter. 41) The ARQ option should be set to YES if this protocol requires an ERROR Correcting Modem (MNP) or such. Protocols such as Ymodem-G and Xmodem-G require Error Correcting Modems and have been installed as Internal Protocols. 42) At this point you will need to exit CMSM (Save the information) and create 2 batch files by the names of: CAMRx.BAT (Where x is the Protocol Letter) CAMSx.BAT (Where x is the Protocol Letter) Both of these files work exactly as PCBoard does for external Protocols. Please see your PCBoard documentation on how to implement these. If you already have some PCBoard external Protocols, simply copy over your PCBRx.BAT and PCBSx.BAT and rename them appropriately. Cam-Mail will work just fine with these. In case you don't have your PCBoard manual handy here are what each % value represents: %1 - Com Port Number %2 - PC to Modem Speed (DTE) %3 - Path/Name of File to Transfer %4 - Connect Speed displayed by PCBoard to the Caller %5 - Carrier Speed %6 - Path to the WORK directory (For Bi-Directional Protocols) 43) Now UNZIP the HELPMENU.ZIP into your HELP directory that you specified in the CMSM.EXE program. Be sure that you put the NEWUSER file in the proper directory. Forcing Conference Scanning --------------------------- If you wish to FORCE users to scan a particular conference here's what you need to do: 1) First create a file called FORCExxx (Where xxx represents the security level of the users) 2) In this file you need to add the conference number followed by a ';' and the type of conference scan. You can have up to 25 Forced Conferences. Example: 0;A 5;Y 10;B The above example will force the user to scan 3 conferences: Conference #0 (Scans All Messages and exports them) Conference #5 (Scans for only messages to the USER) Conference #10 (Scans for messages to ALL and the USER) 3) That's it for Forcing Conference Scanning.... Cam-Mail Batch Files -------------------- If you are running a Multi-Node BBS please be aware that you *MUST* make *ALL* Batch files used by Cam-Mail as READ-ONLY. You do this by using the ATTRIB file. Once you have everything setup go into your CAM-MAIL directory and type: ATRRIB +r *.BAT This will prevent share violations on the BATCH files. Now all you need to do is make your MAIL batch file to load the door. There several command line switches which need to be passed to Cam-Mail. IMPORTANT: You NEED to run the CAM-MAIL.EXE in the CAM-MAIL directory. DO NOT run it from your PCB directory. Here is the information for the command line switches that NEED to be passed to CAM-MAIL.EXE: CAM-MAIL.EXE Path_To_PCB_Directory BiosWrites(YES/NO) Optional[Work Drive Letter] Examples: CAM-MAIL.EXE C:\PCB NO This would tell Cam-Mail that your PCBoard Directory is at C:\PCB and that you do not want Bios Writes. CAM-MAIL.EXE C:\PCB YES G This would tell CAm-mail that your PCBoard Direcotry is at C:\PCB and that you do want Bios Writes and that you want to override the configuration Work Drive to the G Drive. Please note that the First TWO switches are necessary. The third one is an option. I had some Beta Testers who had different Ram Disks on each Node so they needed a way to override the configuration work drive. NOTE: There are several extra EXE files for maintaning your BBS. These are as follows: /DUPON - Force Duplicate Checking (Be sure you run CRCSM) /NOWINDOW - The BOX Window will be disabled for External Shells Letter - The RAM DRIVE Letter to use for a WORK Drive. These switches MUST follow the other command line switches. Here is an example of how to use all three optional switches: CAM-MAIL.EXE C:\PCB NO Z /DUPON /NOWINDOW This would use my ramdisk designated as Drive Z, force duplicate checking, and will use No Windows for external shells.